org.springframework.core.codec

Interface Decoder<T>

Type Parameters:

T - the type of elements in the output stream

All Known Subinterfaces:

HttpMessageDecoder<T>

All Known Implementing Classes:

AbstractDecoder, AbstractJackson2Decoder, ByteArrayDecoder, ByteBufferDecoder, DataBufferDecoder, Jackson2JsonDecoder, Jackson2SmileDecoder, Jaxb2XmlDecoder, ResourceDecoder, StringDecoder, XmlEventDecoder

public interface Decoder<T>

Strategy for decoding a DataBuffer input stream into an output stream of elements of type <T>.

Since:

5.0

Author:

Sebastien Deleuze, Rossen Stoyanchev

Method Summary

Modifier and Type	Method and Description
boolean	canDecode(ResolvableType elementType, MimeType mimeType) Whether the decoder supports the given target element type and the MIME type of the source stream.
<any>	decode(<any> inputStream, ResolvableType elementType, MimeType mimeType, java.util.Map<java.lang.String,java.lang.Object> hints) Decode a DataBuffer input stream into a Flux of T.
<any>	decodeToMono(<any> inputStream, ResolvableType elementType, MimeType mimeType, java.util.Map<java.lang.String,java.lang.Object> hints) Decode a DataBuffer input stream into a Mono of T.
java.util.List<MimeType>	getDecodableMimeTypes() Return the list of MIME types this decoder supports.

Method Detail

canDecode

boolean canDecode(ResolvableType elementType,
                  @Nullable
                  MimeType mimeType)

Whether the decoder supports the given target element type and the MIME type of the source stream.

Parameters:

elementType - the target element type for the output stream

mimeType - the mime type associated with the stream to decode (can be null if not specified)

Returns:

true if supported, false otherwise

decode

<any> decode(<any> inputStream,
             ResolvableType elementType,
             @Nullable
             MimeType mimeType,
             @Nullable
             java.util.Map<java.lang.String,java.lang.Object> hints)

Decode a DataBuffer input stream into a Flux of T.

Parameters:

inputStream - the DataBuffer input stream to decode

elementType - the expected type of elements in the output stream; this type must have been previously passed to the canDecode(org.springframework.core.ResolvableType, org.springframework.util.MimeType) method and it must have returned true.

mimeType - the MIME type associated with the input stream (optional)

hints - additional information about how to do encode

Returns:

the output stream with decoded elements

decodeToMono

<any> decodeToMono(<any> inputStream,
                   ResolvableType elementType,
                   @Nullable
                   MimeType mimeType,
                   @Nullable
                   java.util.Map<java.lang.String,java.lang.Object> hints)

Decode a DataBuffer input stream into a Mono of T.

Parameters:

inputStream - the DataBuffer input stream to decode

elementType - the expected type of elements in the output stream; this type must have been previously passed to the canDecode(org.springframework.core.ResolvableType, org.springframework.util.MimeType) method and it must have returned true.

mimeType - the MIME type associated with the input stream (optional)

hints - additional information about how to do encode

Returns:

the output stream with the decoded element

getDecodableMimeTypes

java.util.List<MimeType> getDecodableMimeTypes()

Return the list of MIME types this decoder supports.